home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer)…68k, x86, SPARC, PA-RISC] / NeXTSTEP 3.3 Dev Intel.iso / usr / sybase / doc / bcp_batch.man < prev    next >
Text File  |  1993-04-22  |  2KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                bcp_batch
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  bcp_batch
  6.  
  7.   FUNCTION:
  8.        Save any preceding rows in SQL Server.
  9.  
  10.   SYNTAX:
  11.        DBINT bcp_batch(dbproc)
  12.  
  13.        DBPROCESS *dbproc;
  14.  
  15.   COMMENTS:
  16.  
  17.        o When an application uses bcp_bind() and bcp_sendrow() to  bulk-
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   bcp_batch               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.          copy rows from program variables to SQL Server tables, the rows
  27.          are permanently saved in SQL Server only when the program calls
  28.          bcp_batch() or bcp_done().
  29.  
  30.        o You may call bcp_batch() once every n rows or when there  is  a
  31.          lull between periods of incoming data (as in a telemetry appli-
  32.          cation). Of course, you may choose some other criteria, or  may
  33.          decide  not  to  call bcp_batch() at all. If bcp_batch() is not
  34.          called, the rows  are  permanently  saved  in  SQL Server  when
  35.          bcp_done() is called.
  36.        o For information on the bcp utility program, see its manual page
  37.          in the Commands Reference.
  38.  
  39.   PARAMETERS:
  40.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  41.            connection for a particular front-end/SQL Server process.  It
  42.            contains all the information that DB-Library uses  to  manage
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                bcp_batch
  47.   ______________________________________________________________________
  48.            communications and data between the front end and SQL Server.
  49.  
  50.   RETURNS:
  51.        The number of rows saved since the last call to  bcp_batch(),  or
  52.        -1 in case of error.
  53.  
  54.   SEE ALSO:
  55.        bcp_bind, bcp_done, bcp_sendrow
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.